본 게시글의 원문은 Yann Debray의 MATLAB with Python Book 입니다. 해당 책은 MIT 라이센스를 따르기 때문에 개인적으로 번역하여 재배포 합니다. 본 포스팅에는 추후 유료 수익을 위한 광고가 부착될 수도 있습니다.

MIT License

Copyright (c) 2023 Yann Debray

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

본 게시물에서 활용된 소스 코드들은 모두 Yann Debray의 GitHub Repo에서 확인할 수 있습니다.

8.2. Quarto와 Pandoc으로 이 책 생성하기

이 책은 Word, 라이브 스크립트, Jupyter Notebook 및 Markdown과 같은 다양한 편집 도구로 작성되었습니다. 일관성을 유지하고 다양한 형식 생성을 자동화하기 위해 다양한 변환이 적용됩니다:

  • 라이브 스크립트 > 워드
  • 라이브 스크립트 > 마크다운
  • 라이브 스크립트 > 주피터 노트북
  • 주피터 노트북 > 마크다운
  • 주피터 노트북 > 워드

저는 Posit(이전에는 RStudio로 알려진 회사)에서 개발한 오픈 소스 소프트웨어인 Quarto를 사용하고 있습니다. Quarto는 Markdown으로 작성하고 Word, PDF, HTML, Markdown 및 Jupyter 노트북을 포함한 여러 형식으로 책을 생성할 수 있는 범용 문서 변환기인 Pandoc을 기반으로 구축되었습니다.

Quarto는 MATLAB과 Python을 포함한 여러 언어의 코드를 지원하며, VS Code 또는 Jupyter에서 실행할 수 있는 인터랙티브 코드 스니펫을 제공하여 기술 서적을 작성하는 데 훌륭한 도구입니다.

다음은 Jupyter 노트북에서 워드 문서를 생성하는 명령의 한 예입니다:

quarto pandoc notebook.ipynb -s -o README.md